home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.012 < prev    next >
Encoding:
Text File  |  1990-01-09  |  13.5 KB  |  345 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. Apple IIGS
  8. #12:    Tool Set Interdependencies
  9.  
  10. Revised by:    Matt Deatherage & Dave Lyons                      January 1990
  11. Written by:    Jim Merritt                                         April 1987
  12.  
  13. This Technical Note lists all known interdependencies between system tool sets 
  14. on the Apple IIGS.
  15. Changes since July 1989:  Apple now recommends starting the Desk Manager 
  16. last.
  17. _____________________________________________________________________________
  18.  
  19. A tool set is dependent upon another if you must start the latter before 
  20. starting the former.  You should start tool sets in the order listed below.  
  21. Names marked with an asterisk (*) indicate a recommendation to start the 
  22. corresponding tool set, but the order is not required for operation of the 
  23. dependent tool.  Apple recommends using StartUpTools to start up all the tool 
  24. sets your application needs.  See the Apple IIGS Toolbox Reference, Volume 3 
  25. for more details.
  26.  
  27.  
  28. Tool Set Interdependencies
  29.  
  30. Tool Locator                                 Tool #1 ($01)
  31.     No dependencies.  Always start this tool set before any others.
  32.  
  33. Memory Manager                               Tool #2 ($02)
  34.     Tool Locator             (#1)
  35.  
  36. Miscellaneous Tools                          Tool #3 ($03)
  37.     Tool Locator             (#1)
  38.     Memory Manager           (#2)
  39.  
  40. QuickDraw II                                 Tool #4 ($04)
  41.     Tool Locator             (#1)
  42.     Memory Manager           (#2)
  43.     Miscellaneous Tools      (#3)
  44.  
  45. Desk Manager                                 Tool #5 ($05)
  46.     Tool Locator             (#1)
  47.     Memory Manager           (#2)
  48.     Miscellaneous Tools      (#3)
  49.     QuickDraw II             (#4)
  50.     Event Manager            (#6)
  51.     Window Manager           (#14)
  52.     Control Manager          (#16)
  53.     Menu Manager             (#15)
  54.     Line Edit                (#20)
  55.     Dialog Manager           (#21)
  56.     Scrap Manager            (#22)
  57.  
  58. Event Manager                                Tool #6 ($06)
  59.     Tool Locator             (#1)
  60.     Memory Manager           (#2)
  61.     Miscellaneous Tools      (#3)
  62.  
  63. Scheduler                                    Tool #7 ($07)
  64.     Tool Locator             (#1)
  65.     Memory Manager           (#2)
  66.     Miscellaneous Tools      (#3)
  67.  
  68. Sound Tools Set                              Tool #8 ($08)
  69.     Tool Locator             (#1)
  70.     Memory Manager           (#2)
  71.     Miscellaneous Tools      (#3)
  72.  
  73. Apple Desktop Bus (ADB)                      Tool #9 ($09)
  74.     Tool Locator             (#1)
  75.  
  76. SANE (Standard Apple Numeric Environment)    Tool #10 ($0A)
  77.     Tool Locator             (#1)
  78.     Memory Manager           (#2)
  79.  
  80. Integer Math Tools                           Tool #11 ($0B)
  81.     Tool Locator             (#1)
  82.  
  83. Text Tools                                   Tool #12 ($0C)
  84.     Tool Locator             (#1)
  85.  
  86. Window Manager                               Tool #14 ($0E)
  87.     Tool Locator             (#1)
  88.     Memory Manager           (#2)
  89.     Miscellaneous Tools      (#3)
  90.     QuickDraw II             (#4)
  91.     Event Manager            (#6)
  92.     Control Manager          (#16)
  93.     Menu Manager             (#15)
  94.     * Line Edit              (#20)           For AlertWindow call only
  95.     * Font Manager           (#27)           For AlertWindow call only
  96.     * Resource Manager       (#30)           For using resources in Window 
  97.                                              Manager calls.
  98.  
  99. Menu Manager                                 Tool #15 ($0F)
  100.     Tool Locator             (#1)
  101.     Memory Manager           (#2)
  102.     Miscellaneous Tools      (#3)
  103.     QuickDraw II             (#4)
  104.     Event Manager            (#6)
  105.     Window Manager           (#14)
  106.     Control Manager          (#16)
  107.     * Resource Manager       (#30)           For using resources in Menu 
  108.                                              Manager calls.
  109.  
  110. Control Manager                              Tool #16 ($10)
  111.     Tool Locator             (#1)
  112.     Memory Manager           (#2)
  113.     Miscellaneous Tools      (#3)
  114.     QuickDraw II             (#4)
  115.     Event Manager            (#6)
  116.     Window Manager           (#14)
  117.     Menu Manager             (#15)
  118.     * QuickDraw Auxiliary    (#18)           For statText controls.
  119.     * Line Edit              (#20)           For editLine controls.
  120.     * Font Manager           (#27)           For statText controls.
  121.     * List Manager           (#28)           For list controls.
  122.     * Resource Manager       (#30)           For using resources in Control 
  123.                                              Manager calls.
  124.     * Text Edit              (#34)           For editText controls.
  125.  
  126. Note:  You should consider the Window, Control, and Menu Managers as one unit 
  127.        and start them in the given order.
  128.  
  129. System Loader                                Tool #17 ($11)
  130.     Tool Locator             (#1)
  131.     Memory Manager           (#2)
  132.     Miscellaneous Tools      (#3)
  133.  
  134. QuickDraw Auxiliary Routines                 Tool #18 ($12)
  135.     Tool Locator             (#1)
  136.     Memory Manager           (#2)
  137.     Miscellaneous Tools      (#3)
  138.     QuickDraw II             (#4)
  139.     * Font Manager           (#27)
  140.  
  141. Note:  QuickDraw Auxiliary uses the Font Manager in the picture drawing 
  142.        routines.  For proper operation, you should start the Font Manager 
  143.        before using the QuickDraw Auxiliary picture routines; however, the 
  144.        picture routines do not fail if the Font Manager is not present.
  145.  
  146. Print Manager                                Tool #19 ($13)
  147.     Tool Locator             (#1)
  148.     Memory Manager           (#2)
  149.     Miscellaneous Tools      (#3)
  150.     QuickDraw II             (#4)
  151.     QuickDraw Auxiliary      (#18)
  152.     Event Manager            (#6)
  153.     Window Manager           (#14)
  154.     Control Manager          (#16)
  155.     Menu Manager             (#15)
  156.     Line Edit                (#20)
  157.     Dialog Manager           (#21)
  158.     List Manager             (#28)
  159.     Font Manager             (#27)
  160.  
  161. Line Edit                                    Tool #20 ($14)
  162.     Tool Locator             (#1)
  163.     Memory Manager           (#2)
  164.     Miscellaneous Tools      (#3)
  165.     QuickDraw II             (#4)
  166.     Event Manager            (#6)
  167.     * QuickDraw Auxiliary    (#18)           For Text2 items; see below
  168.     Scrap Manager            (#22)
  169.     * Font Manager           (#27)           For Text2 items; see below
  170.  
  171. Dialog Manager                               Tool #21 ($15)
  172.     Tool Locator             (#1)
  173.     Memory Manager           (#2)
  174.     Miscellaneous Tools      (#3)
  175.     QuickDraw II             (#4)
  176.     Event Manager            (#6)
  177.     Window Manager           (#14)
  178.     Control Manager          (#16)
  179.     Menu Manager             (#15)
  180.     * QuickDraw Auxiliary    (#18)           For Text2 items; see below
  181.     Line Edit                (#20)
  182.     * Font Manager           (#27)           For Text2 items; see below
  183.  
  184. Note:  Line Edit, the Dialog Manager, and the Control Manager require the 
  185.        presence of the Font Manager and QuickDraw Auxiliary if you use 
  186.        LETextBox2, statText controls, or LongStatText2 items which require any 
  187.        font styling (e.g., outline, boldface, etc.).
  188.  
  189. Scrap Manager                                Tool #22 ($16)
  190.     Tool Locator             (#1)
  191.     Memory Manager           (#2)
  192.  
  193. Standard File Operations                     Tool #23 ($17)
  194.     Tool Locator             (#1)
  195.     Memory Manager           (#2)
  196.     Miscellaneous Tools      (#3)
  197.     QuickDraw II             (#4)
  198.     Event Manager            (#6)
  199.     Window Manager           (#14)
  200.     Control Manager          (#16)
  201.     Menu Manager             (#15)
  202.     Line Edit                (#20)
  203.     Dialog Manager           (#21)
  204.     * List Manager           (#28)    
  205.     * Resource Manager       (#30)           For using resources in 
  206.                                              Standard File Operations 
  207.                                              calls.
  208.  
  209. Note:  Standard File 3.0 and later use the List Manager for displaying a list 
  210.        of file names.  Although Standard File functions properly if the 
  211.        application has not started the List Manager, it saves time if the 
  212.        application does so.
  213.  
  214. Note Synthesizer                             Tool #25 ($19)
  215.     Tool Locator             (#1)
  216.     Memory Manager           (#2)
  217.     Sound Tools              (#8)
  218.  
  219. Note Sequencer                               Tool #26 ($1A)
  220.     Tool Locator             (#1)
  221.     Memory Manager           (#2)
  222.     Sound Tools              (#8)
  223.     Note Synthesizer         (#25)
  224.  
  225. Note:  The Note Sequencer automatically handles the start and shutdown of the 
  226.        Free-Form Sound Tools (#8) and the Note Synthesizer (#25), so programs 
  227.        that use the Note Sequencer must not execute start or shutdown calls 
  228.        for those tools.  Automatic start does not imply automatic loading.  
  229.        If you plan to use the Note Sequencer, you must still load the Free-Form 
  230.        Sound Tool and the Synthesizer Tool explicitly through calls to the Tool 
  231.        Locator routines LoadTools or LoadOneTool or by calling the System 
  232.        Loader and Tool Locator directly in appropriate cases.
  233.  
  234. Font Manager                                 Tool #27 ($1B)
  235.     Tool Locator             (#1)
  236.     Memory Manager           (#2)
  237.     * Miscellaneous Tools    (#3)            For ChooseFont call only
  238.     QuickDraw II             (#4)
  239.     * Integer Math Tools     (#11)           For ChooseFont call only
  240.     * Window Manager         (#14)           For ChooseFont call only
  241.     * Control Manager        (#16)           For ChooseFont call only
  242.     * Menu Manager           (#15)           For FixFontMenu call only
  243.     * List Manager           (#28)           For FixFontMenu
  244.                                              and ChooseFont calls
  245.     * Line Edit              (#20)           For ChooseFont call only
  246.     * Dialog Manager         (#21)           For ChooseFont call only
  247.  
  248. List Manager                                 Tool #28 ($1C)
  249.     Tool Locator             (#1)
  250.     Memory Manager           (#2)
  251.     Miscellaneous Tools      (#3)
  252.     QuickDraw II             (#4)
  253.     Event Manager            (#6)
  254.     Window Manager           (#14)
  255.     Control Manager          (#16)
  256.     Menu Manager             (#15)
  257.  
  258. Audio Compression and Expansion (ACE)        Tool #29 ($1D)
  259.     Tool Locator             (#1)
  260.     Memory Manager           (#2)
  261.  
  262. Resource Manager                             Tool #30 ($1E)
  263.     Tool Locator             (#1)
  264.     Memory Manager           (#2)
  265.  
  266. MIDI Tools                                   Tool #32 ($20)
  267.     Tool Locator             (#1)
  268.     Memory Manager           (#2)
  269.     Miscellaneous Tools      (#3)
  270.     Sound Manager            (#8)
  271.     * Note Synthesizer       (#25)
  272.  
  273. Note:  The MIDI Tools require the Note Synthesizer if you intend to use the 
  274.        MIDI clock feature.  If you are not using the MIDI clock, the Note 
  275.        Synthesizer is not required.
  276.  
  277. Text Edit                                    Tool #34 ($22)
  278.     Tool Locator             (#1)
  279.     Memory Manager           (#2)
  280.     Miscellaneous Tools      (#3)
  281.     QuickDraw II             (#4)
  282.     Event Manager            (#6)
  283.     Window Manager           (#14)
  284.     Menu Manager             (#15)
  285.     Control Manager          (#16)
  286.     QuickDraw Auxiliary      (#18)
  287.     Scrap Manager            (#22)
  288.     Font Manager             (#27)
  289.     * Resource Manager       (#30)           For using resources in Text 
  290.                                              Edit calls.
  291.  
  292.  
  293. Recommended Start Order
  294.  
  295. A close look at the preceding information will reveal apparent "circular 
  296. dependencies" between various tool sets (i.e., two or more tool sets may 
  297. depend upon each other).  To resolve the issue of which tool set to start 
  298. first in such a situation, here is a list of the most commonly used tool sets, 
  299. given in the order in which an application should start them.  You may start 
  300. those tools which are indented at a specific level at that time or any time 
  301. thereafter.
  302.  
  303.     Tool Locator                  (#1)
  304.         ADB Tools                 (#9)
  305.         Integer Math Tools        (#11)
  306.         Text Tools                (#12)
  307.     Memory Manager                (#2)
  308.         SANE                      (#10)
  309.         ACE                       (#29)
  310.     Resource Manager              (#30)
  311.     Miscellaneous Tools           (#3)
  312.         Scheduler                 (#7)
  313.         System Loader             (#17)      LoaderStartup does nothing.
  314.     QuickDraw II                  (#4)
  315.         QuickDraw II Auxiliary    (#18)
  316.     Event Manager                 (#6)
  317.     Window Manager                (#14)
  318.     Control Manager               (#16)
  319.     Menu Manager                  (#15)
  320.     LineEdit                      (#20)
  321.     Dialog Manager                (#21)
  322.         either
  323.             Sound Tools then      (#8)
  324.             Note Synthesizer      (#25)
  325.         or
  326.             Note Sequencer        (#26)
  327.         MIDI Tools                (#32)
  328.     Standard File Operations      (#23)
  329.     Scrap Manager                 (#22)
  330.     List Manager                  (#28)
  331.     Font Manager                  (#27)
  332.     Print Manager                 (#19)
  333.     Text Edit                     (#34)
  334.     Desk Manager                  (#5)
  335.  
  336. Note:  Although you may start the sound-related tools any time after the 
  337.        Miscellaneous Tools, we recommend you start them after most of the 
  338.        Desktop-related tools.  We also recommend you start the Desk Manager 
  339.        last and shut it down first.
  340.  
  341.  
  342. Further Reference
  343. _____________________________________________________________________________
  344.   o  Apple IIGS Toolbox Reference
  345.